home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / STRADD.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  49 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _StrAdd( cString, cInsert, nPos ) --> cString
  8.  
  9. PARAMETERS:
  10.  
  11. cString : String to be added to
  12. cInsert : String to insert (or append)
  13. nPos    : Position at which to insert the insert string
  14.  
  15. SHORT:
  16.  
  17. Insert one string into another at a specified point.
  18.  
  19. DESCRIPTION:
  20.  
  21. _StrAdd() inserts one string into another at a specified location.
  22.  
  23. If nPos is not passed, or if nPos is greater than the length of cString,
  24. then cInsert is appended to cString, else cInsert is inserted into cString
  25. at position nPos.  If cString is empty, the above rule applies since
  26. the insert string will be of greater length and the return value
  27. will effectively be the cInsert string.
  28.  
  29. NOTE:
  30.  
  31.  
  32.  
  33. EXAMPLE:
  34.  
  35. String1 = 'THIS IS A STRING'
  36. STRING2 = ' NOT'
  37. String3 = _StrAdd(String1,String2,8)
  38.  
  39. Result: string3 = "THIS IS NOT A STRING"
  40.  
  41. Another example:
  42.  
  43. String1 = 'THIS IS A STRING'
  44. String2 = _StrAdd(String1," NOT",8)
  45.  
  46. Result: string2 = "THIS IS NOT A STRING"
  47.  
  48. ******************************************************************************/
  49.